From fc1bbeb0910029fd50a93996f727c3464b77d0aa Mon Sep 17 00:00:00 2001 From: "kaf24@firebug.cl.cam.ac.uk" Date: Tue, 16 May 2006 09:21:33 +0100 Subject: [PATCH] Extend xentrace man page. From: Kaleb Pederson Signed-off-by: Keir Fraser --- tools/xentrace/xentrace.8 | 75 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) diff --git a/tools/xentrace/xentrace.8 b/tools/xentrace/xentrace.8 index 93c86ac8ad..c7421340ee 100644 --- a/tools/xentrace/xentrace.8 +++ b/tools/xentrace/xentrace.8 @@ -35,6 +35,81 @@ all new records to the output .B -s, --poll-sleep=p set the time, p, (in milliseconds) to sleep between polling the buffers for new data. +.TP +.B -c, --cpu-mask=c +set cpu-mask +.TP +.B -e, --evt-mask=e +set evt-mask +.TP +.B -?, --help +Give this help list +.TP +.B --usage +Give a short usage message +.TP +.B -V, --version +Print program version + +.SS Event Classes (Masks) +The following event classes (masks) can be used to filter the events being +gathered by xentrace: +.PP + \fIID\fP \fIDescription\fP +.PP + 0x0001f000 TRC_GEN + 0x0002f000 TRC_SCHED + 0x0004f000 TRC_DOM0OP + 0x0008f000 TRC_VMX + 0x000af000 TRC_MEM + 0xfffff000 TRC_ALL + + +.SS Event Subclasses (More Masks) +The following event subclasses (masks) can also be used to filter the events being +gathered by xentrace: +.PP + \fIID\fP \fIDescription\fP +.PP + 0x00081000 TRC_VMXEXIT + 0x00082000 TRC_VMXTIMER + 0x00084000 TRC_VMXINT + 0x00088000 TRC_VMXIO + + +.SS Events +.B xentrace +collects the following events from the trace buffer: +.PP + \fIID\fP \fIDescription\fP +.PP + 0x0002f001 TRC_SCHED_DOM_ADD + 0x0002f002 TRC_SCHED_DOM_REM + 0x0002f003 TRC_SCHED_SLEEP + 0x0002f004 TRC_SCHED_WAKE + 0x0002f005 TRC_SCHED_YIELD + 0x0002f006 TRC_SCHED_BLOCK + 0x0002f007 TRC_SCHED_SHUTDOWN + 0x0002f008 TRC_SCHED_CTL + 0x0002f009 TRC_SCHED_ADJDOM + 0x0002f010 TRC_SCHED_SWITCH + 0x0002f011 TRC_SCHED_S_TIMER_FN + 0x0002f012 TRC_SCHED_T_TIMER_FN + 0x0002f013 TRC_SCHED_DOM_TIMER_FN + 0x0002f014 TRC_SCHED_SWITCH_INFPREV + 0x0002f015 TRC_SCHED_SWITCH_INFNEXT + + 0x000af001 TRC_MEM_PAGE_GRANT_MAP + 0x000af002 TRC_MEM_PAGE_GRANT_UNMAP + 0x000af003 TRC_MEM_PAGE_GRANT_TRANSFER + + 0x00081001 TRC_VMX_VMEXIT + 0x00081002 TRC_VMX_VMENTRY + + 0x00082001 TRC_VMX_TIMER_INTR + + 0x00084001 TRC_VMX_INT +.PP .SH AUTHOR Mark A. Williamson -- 2.30.2